home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 034a / carib25.zip / CARIB.DOC < prev    next >
Text File  |  1992-01-01  |  10KB  |  217 lines
  1.             * * * * * * * * * * * * * * * * * * * * * * * * *
  2.             *                                               *
  3.             *             CARIBBEAN CONTRABAND              *
  4.             *                 VERSION  2.5                  *
  5.             *                   01/01/92                    *
  6.             *                                               * 
  7.             *                  Written By:                  *
  8.             *                 Michael Goetz                 *
  9.             *                                               *
  10.             *            Copyright (c) 1991, 1992           *
  11.             *               All Rights Reserved             *
  12.             *                                               *
  13.             *                 SUPPORT  BBS:                 *
  14.             *               The SpeakEasy BBS               *
  15.             *                 (407) 291-4626                * 
  16.             *          PCB 14.5 * HST D/S 1200-19,200       *
  17.             *                                               *
  18.             * * * * * * * * * * * * * * * * * * * * * * * * * 
  19.  
  20. INTRODUCTION
  21. ------------
  22.  Caribbean Contraband is a fun and addictive game DOOR for Bulletin
  23.  Board Systems.  Playing the game is easy to learn.  As you travel the
  24.  Caribbean, you'll test your skills in buying and selling Contraband.  
  25.  The strategy is knowing when to buy particular items and when to sell 
  26.  them, while avoiding various obstacles that you'll meet along the way.  
  27.  
  28. FEATURES
  29. --------
  30.  - ANSI color and Mono screens
  31.  - Supports up to 340k bps
  32.  - Supports most BBS Software
  33.  - Supports non-standard port & IRQ
  34.  - Supports FOSSIL drivers
  35.  - Easy installation and maintainance
  36.  - Creates graphic/non-graphic bulletin (Reg. Req.)
  37.  - Automatically maintained Bulletin/Top Score
  38.                               
  39. INSTALLATION
  40. ------------
  41.  Installation is very easy.  Create a directory to hold all CARIBBEAN
  42.  CONTRABAND files and unzip CARIBxx.ZIP into this directory.
  43.  
  44.  Files should consist of:
  45.   CARIB25.EXE ..... Main program file
  46.   CCSETUP.EXE ..... Setup utility to create configuration file (CARIB.CFG)
  47.   CARIB.INS ....... On-line Instruction file
  48.   CARIB.USR ....... User file (Must have this file to operate game!)
  49.   CARIB  .......... Sample Batch file (modify as needed)
  50.   CARIB.CFG ....... Sample Configuration file (modify as needed)
  51.   CCKILL.EXE ...... Bulletin - Top Score maintainance file
  52.   CARIB.DOC ....... You're reading it!
  53.   REGISTER.FRM .... Please use it... I need the money!!!  :-)
  54.   UPGRADE.TXT ..... IMPORTANT: Read this if upgrading from previous version!
  55.   WHATSNEW.TXT .... History file
  56.   FILE_ID.DIZ ..... Description file for PCBoard 14.5a only!
  57.  
  58.  Change to the directory you created and run CCSETUP.EXE and enter the
  59.  data in the fields as applicable to your system.  The first line will 
  60.  ask for the full path and filename of your BBS information file.  For
  61.  example: C:\PCB\PCBOARD.SYS.  Caribbean Contraband uses this filename 
  62.  to determine the BBS software which is being used as follows:
  63.  
  64.  PCBOARD.SYS   (PCBoard)
  65.  CALLINFO.BBS  (Wildcat!)
  66.  DOOR.SYS      (GAP and other systems using std. DOOR.SYS)
  67.  DORINFOx.DEF  (QuickBBS/Remote Access)
  68.  
  69.  Line <4> will ask for the path & name for the non-graphics Bulletin
  70.  file that will be created after each completed game.  The Bulletin
  71.  will only be created with the REGISTERED VERSION.   Until registered,
  72.  place "NONE" in this field.
  73.  
  74.  Line <5> will ask for the path and name for the Graphics Bulletin
  75.  file that will be created after each completed game.  The Bulletin
  76.  will only be crated with the REGISTERED VERSION.  Until registered,
  77.  place "NONE" in this field.
  78.  
  79.  Line <6> will ask for the registration code number.  Until the program
  80.  is registered, place 0000 in the Registration field.
  81.  
  82.  Line <7> will ask for the number of moves per game (max. of 50).  I
  83.  recommend 30 moves as being a good starting number.   This takes an
  84.  average player approximately 5 minutes to complete a game.  Keep in
  85.  mind that a player's score is *not* recorded to the Top Score file
  86.  unless he/she completes a game. NOTE: UNREGISTERED VERSION forces
  87.  30 moves. Place 30 in this field until program is registered.
  88.  
  89.  Line <8> asks for the number of games allowed each user per day
  90.  (max. of 10).  NOTE: UNREGISTERED VERSION forces two (2) games.
  91.  place 2 in this field until program is registered.
  92.  
  93.  Line <9> will ask for the maximum number of Top Scores to write to
  94.  the Top Score file and Bulletins (max. of 50).  Enter 50 until
  95.  registered.
  96.  
  97.  NOTE: ALL FIELDS *MUST* BE FILLED IN OR PROGRAM FAILURE WILL OCCUR !!
  98.  
  99.  After entering all of the information, exit CCSETUP.EXE by pressing
  100.  <S>ave....  This will create the CARIB.CFG file and place it in the
  101.  current directory.  
  102.  
  103.  Consult your BBS Software manual on how to create a DOOR batch file,
  104.  and modify the CARIB! batch file supplied.  An example batch file for
  105.  PCBoard:
  106.  
  107.   @Echo off
  108.   C:
  109.   CD\PCB\DOORS\CARIB
  110.   CARIB25 CARIB.CFG     <---- This is the command line for calling
  111.   C:                        Caribbean Contraband.  MUST BE THE SAME
  112.   CD\PCB                    or program failure will occur !!  For
  113.   BOARD.BAT                 non-standard port address and IRQ, see
  114.                             NOTE below!
  115.  
  116.  NOTE: If you need to specify a non-standard port address and IRQ,
  117.        then you will need to add this information to the BATCH file
  118.        calling CARIBBEAN CONTRABAND. The syntax is PORT:AAAA:X where
  119.        AAAA is the base address and X is the IRQ. An example batch
  120.        file:
  121.              @echo off
  122.              c:
  123.              cd\pcb\doors\carib
  124.              carib25 carib.cfg PORT:03E8:5  <---- NEW COMMAND LINE!
  125.              c:
  126.              cd\pcb
  127.              board.bat
  128.  
  129.  
  130.        CARIBBEAN CONTRABAND will also support the use of FOSSIL drivers.
  131.        The syntax for a FOSSIL driver is: PORT:F:P.  The 'F' tells the
  132.        door to use a Fossil driver for it's communications, and the 
  133.        'P' following it tells it which port to use for the Fossil.
  134.        Example: PORT:F:1 tells it to use a Fossil driver for port 1.
  135.  
  136.  CCKILL.EXE is a utility that can be called from the EVENT.SYS (or the
  137.  equivalent for your BBS Software) that will automatically, on the 1st
  138.  of each month, create/update the "Last Month's Top Smuggler" (which is 
  139.  displayed on the Top Score screen and the Bulletin after registering). 
  140.  It will also delete the previous month's Top Scores (CARIB.SCR), making 
  141.  Caribbean Contraband virtually maintainance free!  It will only execute
  142.  if run on the 1st of the month.  
  143.  
  144.  NOTE: CCKILL.EXE can be forced to run by entering "CCKILL /u" if desired.
  145.  WARNING: This will delete the Top Score file !!
  146.  
  147. MULTI-NODE SYSTEMS
  148. ------------------
  149.  When running more than one node, be sure to have a different configuration
  150.  for each node, and create a batch file for each node.  The configuration
  151.  file for each node can be created easily by entering at the dos prompt:
  152.  CCSETUP CARIBx.CFG, where 'x' is the node number.   This will cause
  153.  CCSETUP.EXE to create a configuration file under the name entered rather
  154.  than the default (CARIB.CFG).
  155.  
  156.  Example CARIB2.BAT file:           Example CARIB2.CFG:
  157.  ------------------------           -------------------
  158.  @echo off                         <1> c:\pcb2\pcboard.sys  <--- path to
  159.  c:                                <2> The SpeakEasy BBS         node 2
  160.  cd\pcb\doors\carib                <3> Michael Goetz             system
  161.  carib25 carib2.cfg                    ....and so on             file.
  162.  c:
  163.  cd\pcb2
  164.  board2.bat
  165.  
  166. REGISTRATION !!
  167. ---------------
  168.  Registration is required if you choose to continue using this DOOR 
  169.  program after a 3 or 4 week evaluation period.  When registered, the
  170.  "[UNREGISTERED EVALUATION COPY]" line will be replaced with the name
  171.  of your BBS followed by the SysOp name as well as the removal of the 
  172.  delay built into the opening and closing screens.  Registration will
  173.  also allow the creation of a colorful graphic Top Score Bulletin which 
  174.  is updated after each completed game.  The total number of Top Scores
  175.  posted can also be specified in the configuration file (maximum of 50)
  176.  as well as the amount of MOVES per game (maximum of 50) and the amount
  177.  of GAMES per day.  PLEASE SUPPORT SHAREWARE!!!
  178.  
  179.  To register your copy of CARIBBEAN CONTRABAND, please fill out the 
  180.  supplied registration form (REGISTER.FRM) and mail it along with a
  181.  small donation of $20.00 or $25.00 (check or Money Order) payable to
  182.  Michael Goetz, address on the form.   Please be sure you enter the
  183.  information on the form as it appears in the CARIB.CFG file.  Your
  184.  registration code is based upon this information!
  185.  
  186.  After receiving your registration form, I will pre-register you on the
  187.  SpeakEasy BBS.  You will then be able to call the SpeakEasy and receive
  188.  your registration code. Please allow at least 7 days prior to calling.
  189.  If you prefer, I will mail your registration code if you supply a self-
  190.  addressed stamped envelope.  
  191.    
  192. APPRECIATION
  193. ------------
  194.  I would like to thank Steve Page, SysOp of the SpeakEasy BBS, and Jim
  195.  Murphey, SysOp of the Coffee Shop BBS, for beta testing the program. 
  196.  Their assistance in the development of Caribbean Contraband is sincerely
  197.  appreciated.
  198.  
  199. SUPPORT
  200. -------
  201.  If you have any questions concerning the setup or operation of CARIBBEAN
  202.  CONTRABAND, I can be reached via email thru PCRelay's (RIME) BBS-DOORS
  203.  conference or at The SpeakEasy BBS, Majic Software's support BBS.
  204.  
  205. LEGALITIES
  206. ----------
  207.  THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  208.  WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  209.  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  210.  IN NO EVENT SHALL THE AUTHOR OR ANYONE INVOLVED WITH THE CREATION AND PRO-
  211.  DUCTION OF THIS PRODUCT BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, OR
  212.  CONSEQUENTIAL DAMAGES RESULTING FROM THE USE OF THIS PROGRAM.  YOUR USE OF 
  213.  THIS PROGRAM CONSTITUTES YOUR AGREEMENT TO THIS DISCLAIMER AND YOUR RELEASE
  214.  OF THE AUTHOR FROM ANY FORM OF LIABILITY OR LITIGATION.
  215.  
  216.                                 - END - 
  217.